RequestMode v1.0
                                Adam Dawes
                            25th December 1995



What is RequestMode?
======================

RequestMode is a little utility designed to complement the Commodore
utilities, 'RequestChoice' and 'RequestFile', primarily of use in AmigaDos
shell scripts and AREXX scripts.

The program displays a requester containing a list of monitor Display
Modes, and waits for the user to select one of them. The selected mode will
then be printed to stdout (in either hex format, or in English) -- so it's
very convenient to redirect the output of RequestMode to an environment
variable.



Using RequestMode
=================

The parameter template for RequestMode is as follows:


  RequestMode TITLE/A, GUI/S, FULLNAME/S, QUOTES/S, PUBSCREEN/K


         Title: The title to be given to the ScreenMode requester that
                opens

           GUI: If this switch is present, only screenmodes that can be
                successfully used for a GUI will be available in the
                ScreenMode requester.

      FullName: This switch instructs RequestMode to print the selected
                screenmode in English, rather than as a Hex number.

        Quotes: If present, this switch instructs RequestMode to put
                double-quotes around the ScreenMode name printed. Note that
                if the FullName switch is not also set, this has no effect.

     PubScreen: Specified a PubScreen on which the ScreenMode requester
                should open.
                

An example application for RequestMode is supplied in the RequestMode
archive, as "VT_SM.script". When executed, this 1-line script will open a
ScreenMode requester, and will then use Viewtek to display all subsequently
selected pictures in the selected screenmode. If you don't have a copy of
Viewtek in your command path with the filename "Viewtek", you will need to
slightly modify the script to contain the correct path/filename.



Requirements
============

RequestMode requires Kickstart 2 or greater, and also the ReqTools
library by Nico François.



Known Bugs
==========

A couple of minor problems have shown themselves during the testing of
RequestMode, though neither should stop it from being useful. The bugs
found are:

 · RequestMode doesn't return a FullName when one of the following Screen-
   Modes are selected:

        EURO72:160 x 400
        EURO72:160 x 800-Interlaced
        EURO72:320 x 400
        EURO72:320 x 800-Interlaced

   The ModeID will still be returned as a hex number if you require. I've
   no idea why this particular bug is occuring. The GetDisplayInfoData()
   function just doesn't return me a name string for those resolutions! :(

 · There are some problems when using RequestMode in combination with the
   backtick (`) character in C-Shell. If you experience problems with
   RequestMode when using the backtick and C-Shell, try performing the same
   command in AmigaDOS, or making an AmigaDOS shell script to perform the
   same function. See the 'VT_SM.script' file for an example.



Legal stuff
===========

RequestMode is freeware. It may be distributed however and wherever you
like.

I accept no responsibility for any damage done to your system, directly or
indirectly, as a result of using RequestMode. You use the program
entirely at your own risk.



History
=======

  v1.0 (39.0)

        Initial release.



Contacting the author
=====================

Please do write to me if you like RequestMode or if you have any problems
with it or suggestions for a new version. I can't promise to reply quickly
if you write via snail-mail, but I will always reply to email messages. I
can be contacted at:

  InterNet
     ad32@brighton.ac.uk
     adam@beachyhd.demon.co.uk

  FidoNet
     Adam Dawes@2:441/93.5

  SnailMail
     Adam Dawes
     47 Friar Road
     Brighton
     BN1 6NH
     England



See Also
========

I have also written a couple of other utilities that complement this and
the Commodore 'Request' commands:

 · 'RequestString', available from Aminet as 'util/batch/requeststring.lha'
   provides a simple and easy way to prompt the user to enter some text
   from within a script. Amongst other things, the requester can have a
   default string already entered, and may have text entered invisibly (for
   passwords, etc.).

 · 'RequestList' (from Aminet as 'util/cli/requestlist11.lha') allows the
   user to select an item from a list of items. The list is built up from
   text in a file you specify.